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Production Note 


This book was produced with the VAX DOCUMENT electronic publishing 
system, a software tool developed and sold by DIGITAL. In this system, 
writers use an ASCII text editor to create source files containing text and 
English-like code; this code labels the structural elements of the document, 
such as chapters, paragraphs, and tables. The VAX DOCUMENT software, 
which runs on the VMS operating system, interprets the code to format the 
text, generate a table of contents and index, and paginate the entire document. 
Writers can print the document on the terminal or line printer, or they can use 
DIGITAL-supported devices, such as the LN03 laser printer and PostScript 
printers (PrintServer 40 or LN03R ScriptPrinter), to produce a typeset-quality 
copy containing integrated graphics. 




PostScript is a trademark of Adobe Systems, Inc. 
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Preface 


Conventions 


Convention 

Meaning 


mi 

In examples, a key name (usually abbreviated) 
shown within a box indicates that you press 
a key on the keyboard; in text, a key name is 
not enclosed in a box. In this example, the key 
is the RETURN key. (Note that the RETURN 


key is not usually shown in syntax statements 
or in all examples; however, assume that you 
must press the RETURN key after entering a 
command or responding to a prompt.) 

CTRL/C 

A key combination, shown in uppercase with a 
slash separating two key names, indicates that 
you hold down the first key while you press the 
second key. For example, the key combination 
CTRL/C indicates that you hold down the key 
labeled CTRL while you press the key labeled C. 
In examples, a key combination is enclosed in a 
box. 

$ SHOW TIME 

05-JUN-1988 11:55:22 

In examples, system output (what the system 
displays) is shown in black. User input (what 
you enter) is shown in red. 

$ TYPE MYFILE.DAT 

In examples, a vertical series of periods, or 
ellipsis, means either that not all the data that 


the system would display in response to a 
command is shown or that not all the data a 
user would enter is shown. 

input-file, . . . 

In examples, a horizontal ellipsis indicates 
that additional parameters, values, or other 
information can be entered, that preceding 
items can be repeated one or more times, or 
that optional arguments in a statement have 
been omitted. 

[logical-name] 

Brackets indicate that the enclosed item is 
optional. (Brackets are not, however, optional 
in the syntax of a directory name in a file 
specification or in the syntax of a substring 
specification in an assignment statement.) 

quotation marks 
apostrophes 

The term quotation marks is used to refer 
to double quotation marks ("). The term 
apostrophe (') is used to refer to a single 
quotation mark. 
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New and Changed Features 


The following enhancements have been made to VMS Sort/Merge Utility for 

Version 5.0: 

• Faster performance overall for all types of files; however, the biggest gain 
in performance is for sequential output files with fixed or variable record 
formats. 

• SORT takes advantage of larger working sets. 

• The /COLLATING—SEQUENCE=cs-name qualifier supports the National 
Character Set (NCS). You can specify the name of an NCS collating 
sequence. 








SORT/MERGE Description 


NAMES.DAT 


BILLING. 

LIS 

1 McKee Michael 

643881 

1 Wilson Brent 

166391 

1 Erickson Sam 

729311 --= 

=—> |McKee Michael 

643881 

1 Wilson Brent 

166391 

1 Erickson Sam 

729311 

iCoolidge Sue 

980341 

IRice Anne 

753731 

iRice Anne 

753731 

ICoolidge Sue 

980341 


By default SORT assumes a key field that 

• Begins in the first position of a record 

• Includes the entire record 

• Contains character data 

• Is sorted in ascending order 

To create an output file, BILLING.LIS, with the records ordered alphabetically 
by customer name, you would use the customer name field as the key. 
Because entire records will be sorted and the customer name key contains 
character data that begins in the first position of the record, you do not 
need to describe the key. You need only pass the input and output file 
specifications, as in the following command: 

$ SORT NAMES.DAT BILLING.LIS 

Note that, whenever you sort on a key field that is different from the default, 
you must describe that key field with the /KEY qualifier. For more details 
concerning keys, see the description of the /KEY qualifier. 


1.1 Multiple Keys 

You can sort with more than one key. Multiple keys must be specified in the 
order of their priority — the primary key specified first, the secondary 
key next, and so on. For example, NAMES.DAT is sorted first on the 
account number key and then by the customer name key with the following 
command: 

$ SORT /KEY=(POSITION:16.SIZE:5,DECIMAL) - 

_$ /KEY=(POSITION:!.SIZE:16.CHARACTER) NAMES.DAT BILLING.LIS 


1.2 Equal Keys 

If two or more records have equal key fields, the order of those records in 
the output file is unpredictable. By specifying the /STABLE qualifier, you 
can maintain the input order of the records. If two or more records have 
equal fields and if you want to retain only one of the records, specify the 
/NODUPLICATES qualifier. /STABLE and /NODUPLICATES cannot be 
specified on the same command line. For more details, see the description of 
the /STABLE and /NODUPLICATES qualifiers. 
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SORT/MERGE Description 


Output File Organization 

By default, the output file has the same organization as that of the first input 
file. If the organization of the output file is to differ from that of the input file, 
you must specify the appropriate qualifier after the output file specification on 
the command line. 


Qualifier 

Purpose 

/FORMAT 

Specifies record format 

/INDEXED-SEQUENTIAL 

Specifies indexed-sequential file organization 

/RELATIVE 

Specifies relative file organization 

/SEQUENTIAL 

Specifies sequential file organization 


If the organization of the output file is indexed-sequential, the file must 
already exist and must be empty. You must also qualify the output file 
parameter with /OVERLAY. 

For more details, see the descriptions of these qualifiers. 


Sorting Process 

SORT arranges files by the following processes: 

• Record 

• Tag 

• Address 

• Indexed 

By default, SORT arranges files by a record process that keeps records intact 
when sorting them and produces an output file of complete records. To 
specify a sorting process, use the /PROCESS qualifier. For a comparison 
of the record, tag, address, and indexed processes, see the /PROCESS 
description in the Command Qualifiers section. 

The /PROCESS qualifier can be used only with SORT; you cannot specify a 
process for MERGE. 


Merging Files 

The Sort/Merge Utility combines up to ten sorted files into one ordered 
output file. All the input files must have the same format and must have 
been sorted on the same key fields. 

For example, BILLING1.LIS and BILLING2.LIS, sorted on the same key, are 
merged to create one output file MAILING.LIS, which contains all the records 
from both files. The following MERGE command, containing the input and 
output file specifications, creates the output file MAILING.LIS: 

$ MERGE BILLINGl.LIS.BILLING2.LIS MAILING.LIS 
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SORT/MERGE Description 


I 


BILLINGl.LIS 


iCoolidge Sue 

1 Erickson Sam 

1 McKee Michael 

980341 
729311 
643881 

MAILING.LIS 




1 Brown Thomas 

235811 

BILLING2.LIS 


ICoolidge Sue 
-> 1 Erickson Sam 

980341 
729311 



1 McKee Michael 

643881 

1 Brown Thomas 

235811 

(Waters Mary 

445671 

1 Waters Mary 

445671 

|Woo Lee 

998071 

IWoo Lee 

998071 




A merge operation is specified in the same way as a sort operation with two 
exceptions: 

• You cannot specify a process for a merge operation. 

• The /CHECK__SEQUENCE qualifier is used only for a merge operation. 

By default, MERGE checks the order of the records. If any records are out of 
order, a diagnostic message will be issued and processing will continue. 


Collating Sequence 

SORT/MERGE arranges character data according to the following collating 
sequences: 

• ASCII 

• EBCDIC 

• MULTINATIONAL 

By default, SORT arranges character data according to the ASCII collating 
sequence. When SORT collates data according to the EBCDIC sequence, 
the output file is arranged according to the EBCDIC sequence, but the data 
remains in ASCII representation. The MULTINATIONAL sequence collates 
the international character set and treats uppercase and lowercase letters in a 
different manner than the ASCII collating sequence. Table SORT-2 lists the 
MULTINATIONAL collating sequences. 

See the /COLLATING—SEQUENCE description in the Command Qualifiers 
Section for more information on the ASCII, EBCDIC, and MULTINATIONAL 
collating sequences. 

You can also define your own collating sequence or modify any of the 
three collating sequences through the use of a specification file. See the 
/COLLATING—SEQUENCE description in the Specification File Qualifiers 
section. 
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SORT/MERGE Description 


4 SORT/MERGE Specification File 

A SORT/MERGE specification file allows you to specify instructions that 
accomplish the following: 

• Select records to be included in the sort/merge operation 

• Reformat the records in the output file 

• Use conditional keys or data 

• Specify multiple record formats 

• Create or modify a collating sequence 

• Reassign work files 

• Use frequently used sort/merge operations 

You use a text editor to create a specification file. Many of the qualifiers used 
in the specification file are similar to the DCL qualifiers used in the command 
line. Note, however, that the syntax of these qualifiers can be different. For 
example, the /KEY qualifier at DCL level has different syntax than the /KEY 
qualifier in the specification file . Each of the qualifiers is explained in detail 
in the Specification File Qualifiers section. 

Any DCL command qualifiers that you specify on the command line override 
corresponding entries in the specification file. For example, if you specify the 
/KEY qualifier in the DCL command line, SORT/MERGE ignores the /KEY 
clause in the specification file. 

Generally, there is no required order in which you must specify the qualifiers 
in a specification file. The order does become significant, however, in the 
following cases: 

• sorting on more than one key field 

• describing the output format 

• defining multiple record types 

When you specify the FOLD, MODIFICATION, and IGNORE keywords with 
the /COLLATING-SEQUENCE, you should specify all MODIFICATION 
and IGNORE clauses before any FOLD clauses. See the /COLLATING- 
SEQUENCE description in the Specification File Qualifiers section for more 
details. 

You can include comments in your specification file by beginning each 
comment line with an exclamation point. Unlike DCL command lines, 
specification files do not need hyphens to continue the line. 

After you create the text of the specification file, pass the file name with the 
/SPECIFICATION qualifier. The default file type for a specification file is 
SRT. 
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SORT/MERGE Description 


Converting Version 3.0 Specification Files 

You can convert specification files that used the format of previous versions of 
SORT/MERGE by using the sort translation utility. First, define the symbol 
SORTTRANS with the following: 

SORTTRANS :== "$SYS$SYSTEM:SRTTRN" 

Then specify the following command line: 

$ SORTTRANS input-file/Snn output-file 

The input-file parameter specifies the name of the specification file from a 
previous version (Version 3.0 or earlier). The /Snn qualifier specifies which 
type of specification file is being converted. Old SORT-32 specification files 
are specified as /S32; old PDP-11 specification files are specified as /SI 1. By 
default, SORTTRANS assumes the /SI 1 qualifier. 

The output-file parameter specifies the name of the specification file that the 
translator utility created with the new format. There is no default file type for 
the input file; the default for the new output specification file is SRT. 

The translator utility includes the specifications from the old format in the 
file with the new format, setting them off with comment markers. Any errors 
found during the conversion of the old specification file are displayed on 
SYSSOUTPUT. 


Entering Terminal Input 

If you want to provide input to SORT interactively at a terminal, specify 
SYS$INPUT as the input file, qualifying it with the size of the longest record 
(in bytes) and the approximate size of the input file (in blocks). After you 
enter the command, enter the input records. Terminate each record by 
pressing RETURN, and terminate the file by pressing CTRL/Z. For example: 

$ SORT /KEY=(POSITION:8,SIZE:20)_ 

_$ SYSSINPUT /F0RMAT=(REC0RD_SIZE=27, FILE_SIZE=10) NAME.LST 
B 2376 FRENCH MARILYN 
V 3899 ROSE JACK 


♦EXIT* 

This sequence of commands creates the output file NAME.LST, which 
contains the sorted records. 


Batch SORT/MERGE Job 

You can run a sort or merge operation as a batch job, thus freeing your 
terminal for other work. Create a DCL command procedure containing the 
sort or merge commands and execute the procedure by using the SUBMIT 
command. See the VMS DCL Dictionary for more information concerning 
batch jobs. 
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SORT/MERGE Description 


Optimization 

If you are dissatisfied with the efficiency of your sort or merge operation, 
you can investigate a number of possibilities to increase efficiency. First, 
you should evaluate the variables in your sorting environment by using the 
/STATISTICS qualifier. After you examine the statistics display, consider any 
of the optimization options presented in the following subsections. 


User Optimization Options 

You can improve SORT efficiency by using a specification file. You can 
use /CONDITION, /INCLUDE, and /OMIT clauses to include only those 
records needed in the output file. Specification file clauses can also be used to 
reformat records to omit unnecessary fields from the output records. 

See the Specification File Qualifiers section for more details. 


Assigning Work Files To Different Devices 

You can also increase SORT efficiency by assigning the location of the work 
files to random-access, mass-storage devices such as disks. Normally, SORT 
places work files on the device SYS$SCRATCH. However, placing work files 
on separate disk-structured devices permits overlap of SORT'S read/write 
cycle. For greatest sorting efficiency, place work files on devices having the 
following attributes: 

• The fastest devices available 

• The devices having the least activity 

• The devices having the most space available 

• Separate devices 

At DCL level, you can select a different device for any work file by specifying: 
ASSIGN device: SORTWORKn 

SORTWORKn is a logical name for the work file, where n indicates the 
number of the work file. Acceptable values are 0 through 9. For example, 
when you specify /WORK_FILES = 3, use SORTWORKO, SORTWORK1, and 
SORTWORK2 in assigning these three work files to other devices. 

You can also use the /WORK-FILES clause of the specification file to assign 
work files. 


Working Set Extent 

For the sort phase, SORT allocates enough memory to hold the input file, but 
not more than the working set extent. During the sort phase, records are read 
into this memory until it is full. If the memory cannot hold all the records, 
SORT transfers sorted strings to a work file on a temporary storage device. 

When a sort operation uses work files, as in most sorts of large files, a larger 
working set increases sort efficiency. The larger the sort data structure, the 
greater chance SORT has of creating longer and fewer sorted strings in the 
work file. Fewer strings mean fewer merge passes and a faster sort. 
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SORT/MERGE Usage Summary 



The VMS Sort/Merge Utility sorts records or merges input files. To sort 
one or more input files, specify the SORT command. These files are 
sorted according to the fields you select and one reordered output file 
is generated. To merge up to 10 input files that have previously been 
sorted according to the same key fields, specify the MERGE command. 
One output file is generated. 

FORMAT 

SORT input-files output-file 

PARAMETERS 

input-files 

Specifies the files to be sorted. Up to 10 input files can be sorted to create one 
output file. Multiple input file specifications must be separated by commas. 
The default file type is DAT. 

output-file 

Specifies the file to be created. Only one file can be specified. If you omit 
a file type in the file specification, SORT defaults to the file type of the first 
input file. 

FORMAT 

MERGE input-files output-file 

PARAMETERS 

input-files 

Specifies the files to be merged. Up to ten files, presorted by the same keys, 
can be specified. Multiple file specifications must be separated by commas. 
The default file type is DAT. 

output-file 

Specifies the merged file to be created. Only one output file can be specified. 

If you omit a file type in the file specification, MERGE defaults to the file type 
of the first input file. 

usage summary 

Both the SORT and MERGE commands invoke the VMS Sort/Merge Utility. 
After completing an operation, the Sort/Merge Utility exits and returns the 
user to DCL command level. You can specify where you want the results of a 
SORT/MERGE operation with the output file parameter. 
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SORT/MERGE 

SORT/MERGE Qualifiers 


SORT/MERGE 

QUALIFIERS 


This section describes the qualifiers to the SORT and MERGE commands. 
These qualifiers enable you to define your key fields, to describe the data in 
those fields, and to specify various SORT options. 
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SORT/MERGE 

/COLLATING_SEQUENCE 


DESCRIPTION 


By default, SORT/MERGE arranges records according to ASCII sequence. 
However, it can also arrange records according to EBCDIC and 
MULTINATIONAL sequence. 

These three collating sequences can be modified to meet your particular needs 
through the use of a specification file. You can also define your own collating 
sequence by using a specification file if one of the three collating sequences 
does not suit your needs. See the description of the specification file for more 
detail. 

Table SORT-1 contains the ASCII collating sequence. 


Table SORT-1 ASCII Collating Sequence 


ASCII 

Hex 

Octal 

Decimal 

NUL 

00 

000 

0 

SOH 

01 

001 

1 

STX 

02 

002 

2 

ETX 

03 

003 

3 

EOT 

04 

004 

4 

ENQ 

05 

005 

5 

ACK 

06 

006 

6 

BEL 

07 

007 

7 

BS 

08 

010 

8 

HT 

09 

Oil 

9 

LF 

OA 

012 

10 

VT 

OB 

013 

11 

FF 

OC 

014 

12 

CR 

OD 

015 

13 

SO 

OE 

016 

14 

SI 

OF 

017 

15 

DLE 

10 

020 

16 

DC1 

11 

021 

17 

DC2 

12 

022 

18 

DC3 

13 

023 

19 

DC4 

14 

024 

20 

NAK 

15 

025 

21 

SYN 

16 

026 

22 

ETB 

17 

027 

23 

CAN 

18 

030 

24 

EM 

19 

031 

25 

SUB 

1A 

032 

26 

ESC 

IB 

033 

27 

FS 

1C 

034 

28 
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SORT/MERGE 

/COLLATING-SEQUENCE 


Table SORT- 

-1 (Cont.) 

ASCII Collating Sequence 

ASCII 

Hex 

Octal 

Decimal 

GS 

ID 

035 

29 

RS 

IE 

036 

30 

US 

IF 

037 

31 

SP 

20 

040 

32 

! 

21 

041 

33 

n 

22 

042 

34 

# 

23 

043 

35 

$ 

24 

044 

36 

% 

25 

045 

37 

& 

26 

046 

38 

/ 

27 

047 

39 

< 

28 

050 

40 

> 

29 

051 

41 

# 

2A 

052 

42 

+ 

26 

053 

43 

, 

2C 

054 

44 

_ 

2D 

055 

45 

#. 

2E 

056 

46 

/ 

2F 

057 

47 

0 

30 

060 

48 

1 

31 

061 

49 

2 

32 

062 

50 

3 

33 

063 

51 

4 

34 

064 

52 

5 

35 

065 

53 

6 

36 

066 

54 

7 

37 

067 

55 

8 

38 

070 

56 

9 

39 

071 

57 


3A 

072 

58 

■ 

3B 

073 

59 

< 

3C 

074 

60 

= 

3D 

075 

61 

> 

3E 

076 

62 

? 

3F 

077 

63 

@ 

40 

100 

64 

A 

41 

101 

65 

B 

42 

102 

66 
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SORT/MERGE 

/COLLATING—SEQUENCE 


Table SORT—2 (Cont.) DEC Multinational Collating Sequence 


HEX 

Code 

Octal 

Code 

Decimal 

Code 

Char or 
Abbrev. 

Description 

09 

Oil 

009 

HT 

Horizontal tabulation 

0A 

012 

010 

LF 

Line feed 

OB 

013 

Oil 

VT 

Vertical tabulation 

oc 

014 

012 

FF 

Form feed 

OD 

015 

013 

CR 

Carriage return 

OE 

016 

014 

SO 

Shift out 

OF 

017 

015 

SI 

Shift in 

10 

020 

016 

DLE 

Data link escape 

11 

021 

017 

DC1 

Device control 1 

12 

022 

018 

DC2 

Device control 2 

13 

023 

019 

DC3 

Device control 3 

14 

024 

020 

DC4 

Device control 4 

15 

025 

021 

NAK 

Negative acknowledge 

16 

026 

022 

SYN 

Synchronous idle 

17 

027 

023 

ETB 

End of transmission block 

18 

030 

024 

CAN 

Cancel 

19 

031 

025 

EM 

End of medium 

1A 

032 

026 

SUB 

Substitute 

IB 

033 

027 

ESC 

Escape 

1C 

034 

028 

FS 

File separator 

ID 

035 

029 

GS 

Group separator 

IE 

036 

030 

RS 

Record separator 

IF 

037 

031 

US 

Unit separator 

20 

040 

032 

SP 

Space 

21 

041 

033 

! 

Exclamation point 

22 

042 

034 

" 

Quotation marks (double quote) 

23 

043 

035 

# 

Number sign 

24 

044 

036 

$ 

Dollar sign 

25 

045 

037 

% 

Percent sign 

26 

046 

038 

& 

Ampersand 

27 

047 

039 

' 

Apostrophe (single quote) 

28 

050 

040 

( 

Opening parenthesis 

29 

051 

041 

) 

Closing parenthesis 

2A 

052 

042 

* 

Asterisk 

2B 

053 

043 

+ 

Plus 

2C 

054 

044 

/ 

Comma 

2D 

055 

045 

- 

Hyphen or minus 


SORT-18 










SORT/MERGE 

/COLLATING-SEQUENCE 


Table SORT- 

-2 (Cont.) 

DEC Multinational Collating Sequence 

HEX 

Octal 

Decimal 

Char or 


Code 

Code 

Code 

Abbrev. 

Description 

2E 

056 

046 

__ 

Period or decimal point 

2F 

057 

047 

/ 

Slash 

30 

060 

048 

0 

Zero 

31 

061 

049 

1 

One 

32 

062 

050 

2 

Two 

33 

063 

051 

3 

Three 

34 

064 

052 

4 

Four 

35 

065 

053 

5 

Five 

36 

066 

054 

6 

Six 

37 

067 

055 

7 

Seven 

38 

070 

056 

8 

Eight 

39 

071 

057 

9 

Nine 

3A 

072 

058 


Colon 

3B 

073 

059 

; 

Semicolon 

3C 

074 

060 

< 

Less than 

3D 

075 

061 

= 

Equals 

3E 

076 

062 

> 

Greater than 

3F 

077 

063 

? 

Question mark 

40 

100 

064 

@ 

Commercial at 

61 

141 

097 

a 

Lowercase a 

41 

101 

065 

A 

Uppercase A 

EO 

340 

224 

a 

Lowercase a with grave accent 

CO 

300 

192 

A 

Uppercase A with grave accent 

El 

341 

225 

a 

Lowercase a with acute acent 

Cl 

301 

193 

A 

Uppercase A with acute accent 

E2 

342 

226 

a 

Lowercase a with circumflex 

C2 

302 

194 

A 

Uppercase A with circumflex 

E3 

343 

227 

a 

Lowercase a with tilde 

C3 

303 

195 

A 

Uppercase A with tilde 

E4 

344 

228 

a 

Lowercase a with umlaut,(diaeresis) 

C4 

304 

196 

A 

Uppercase A with umlaut,(diaeresis) 

62 

142 

098 

b 

Lowercase b 

42 

102 

066 

B 

Uppercase B 

63 

143 

099 

c 

Lowercase c 

43 

103 

067 

C 

Uppercase C 

E7 

347 

231 

S 

Lowercase c with cedilla 

C7 

307 

199 

C 

Uppercase C with cedilla 
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Table SORT-2 (Cont.) DEC Multinational Collating Sequence 


HEX 

Code 

Octal 

Code 

Decimal 

Code 

Char or 
Abbrev. 

Description 

DC 

334 

220 

0 

Uppercase U with umlaut,(diaeresis) 

76 

166 

118 

V 

Lowercase v 

56 

126 

086 

V 

Uppercase V 

77 

167 

119 

w 

Lowercase w 

57 

127 

087 

W 

Uppercase W 

78 

170 

120 

X 

Lowercase x 

58 

130 

088 

X 

Uppercase X 

79 

171 

121 

y 

Lowercase y 

59 

131 

089 

Y 

Uppercase Y 

FD 

375 

253 

v 

Lowercase y with umlaut,(diaeresis) 

DD 

335 

221 

Y 

Uppercase Y with umlaut,(diaeresis) 

7A 

172 

122 

z 

Lowercase z 

5A 

132 

090 

Z 

Uppercase Z 

E6 

346 

230 

ae 

Lowercase ae diphthong 

C6 

306 

198 

/E 

Uppercase AE with diphthong 

F8 

370 

248 

o 

Lowercase o with slash 

D8 

330 

216 

0 

Uppercase 0 with slash 

E5 

345 

229 

3 

Lowercase a with ring 

C5 

305 

197 

A 

Uppercase A with ring 

5B 

133 

091 

[ 

Opening bracket 

5C 

134 

092 

\ 

Backslash 

5D 

135 

093 

] 

Closing bracket 

5E 

136 

094 

* 

Circumflex 

5F 

137 

095 

— 

Underline (underscore) 

60 

140 

096 


Grave accent 

7B 

173 

123 

( 

Opening brace 

7C 

174 

124 

i 

Vertical line 

7D 

175 

125 

) 

Closing brace 

7E 

176 

126 


Tilde 

7F 

177 

127 

DEL 

Delete, rubout 

84 

204 

132 

IND 

Index 

85 

205 

133 

NEL 

Next line 

86 

206 

134 

SSA 

Start of selected area 

87 

207 

135 

ESA 

End of selected area 

88 

210 

136 

HTS 

Horizontal tab set 

89 

211 

137 

HTJ 

Horizontal tab set with justification 

8A 

212 

138 

VTS 

Vertical tab set 
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/COLLATING-SEQUENCE 


Table SORT- 

-2 (Cont.) 

DEC Multinational Collating Sequence 

HEX 

Octal 

Decimal 

Char or 


Code 

Code 

Code 

Abbrev. 

Description 

8B 

213 

139 

PLD 

Partial line down 

8C 

214 

140 

PLU 

Partial line up 

8D 

215 

141 

Rl 

Reverse index 

8E 

216 

142 

SS2 

Single shift 2 

8F 

217 

143 

SS3 

Single shift 3 

90 

220 

144 

DCS 

Device control string 

91 

221 

145 

PU1 

Private use 1 

92 

222 

146 

PU2 

Private use 2 

93 

223 

147 

STS 

Set transmit state 

94 

224 

148 

CCH 

Cancel character 

95 

225 

149 

MW 

Message waiting 

96 

226 

150 

SPA 

Start of protected area 

97 

227 

151 

EPA 

End of protected area 

9B 

233 

155 

CSI 

Control sequence introducer 

9C 

234 

156 

ST 

String terminator 

9D 

235 

157 

OSC 

Operating system command 

9E 

236 

158 

PM 

Privacy message 

9F 

237 

159 

APC 

Application 

A1 

241 

161 

i 

Inverted exclamation mark 

A2 

242 

162 


Cent sign 

A3 

243 

163 

£ 

Pound sign 

A5 

245 

165 

¥ 

Yen sign 

A7 

247 

167 

§ 

Section sign 

A8 

250 

168 

H 

General currency sign 

A9 

251 

169 

© 

Copyright sign 

AA 

252 

170 

£ 

Feminine ordinal indicator 

AB 

253 

171 

« 

Angle quotation mark left 

BO 

260 

176 

o 

Degree sign 

B1 

261 

177 

± 

Plus/minus sign 

B2 

262 

178 

2 

Superscript 2 

B3 

263 

179 

3 

Superscript 3 

B5 

265 

181 


Micro sign 

B6 

266 

182 

1 

Paragraph sign, pilcrow 

B7 

267 

183 

• 

Middle dot 

B9 

271 

185 

1 

Superscript 1 
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/KEY 

Describes key fields, including the position, size, sorting order, and data 
type. By default, SORT reorders a file by sorting entire records with 
character data in ascending order. Any other type of key field must be 
specified. When specifying multiple keys, use a separate /KEY qualifier for 
each key. 

FORMAT 

/KEY=(fleld [,...]) 

QUALIFIER 

VALUES 

POSITION:n 

Specifies the position of the first byte in the key field. A value of 1 to 32,767 
may be specified. The first byte in a record is considered position 1. Both 
the position and the size of the key field must be specified. If a decimal sign 
is stored in a separate byte in the key field, that byte is counted when you 
determine position. J 

SIZE:n 

Specifies the length of the key field. Both the position and size of the key 
field must be specified. The total composite size of all keys and the original 
input record length must be less than 32,767 bytes. If the decimal sign is 
stored in a separate byte in the key field, that byte is not counted toward the 
size of the data. 

The data type of the key determines what values are acceptable when 
specifying size: 

• 1 to 32,767 characters for character data 

• 1, 2, 4, 8, or 16 bytes for binary data 

• 1 to 31 digits for decimal data 

• No value is necessary for floating point data 

ASCENDING 

Orders the sorting operation in ascending alphabetical or numerical order. 
ASCENDING is the default order. 

DESCENDING 

Orders the sorting operation in descending alphabetical or numerical order. 

CHARACTER 

Specifies character data in the key field. CHARACTER is the default data 
type. 

BINARY 

Specifies binary data in the key field. 
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SIGNED 

Specifies signed binary or decimal data in key field. SIGNED is the default 
for binary and decimal data. 

UNSIGNED 

Specifies unsigned binary or decimal data in the key field. 

F—FLOATING 

Specifies F_FLOATING format data in the key field. 

D—FLOATING 

Specifies D—FLOATING format data in the key field. 

G-FLOATING 

Specifies G—FLOATING format data in the key field. 

H—FLOATING 

Specifies H—FLOATING format data in the key field. 

DECIMAL 

Specifies decimal data in the key field. 

TRAILING-SIGN 

Specifies trailing sign decimal data in the key field. TRAILING_SIGN is the 
default for decimal data. 

LEADING-SIGN 

Specifies leading sign decimal data in the key field. 

OVERPUNCHED-SIGN 

Specifies overpunched decimal data in the key field. OVERPUNCHED_SIGN 
is the default for decimal data. 

SEPARATE-SIGN 

Specifies separate sign decimal data in the key field. 

ZONED 

Specifies zoned decimal data in the key field. 

PACKED-DECIMAL 

Specifies packed decimal data in the key field. 

NUMBERm 

Specifies the order of priority of each key if you do not list multiple keys in 
the order of their priority. A value of 1 to 255 may be specified. 

DESCRIPTION 

The /KEY qualifier specifies all the necessary information about a key field. 

If the file is to be sorted using entire records with character data in ascending 
order, you do not need to specify the key information. 

When a key field must be described, you must specify both the position and 
the size of the key. Also, if the sorting or merging operation is to be done 
in descending alphabetic or numeric order, specify DESCENDING in the key 
description. 
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The input record length value is obtained from Record Management Service 
(RMS) unless the user supplies it. 

Internal length is the size in bytes of an internal format node. This includes 
any keys, data, a word to store the length, record file addresses (RFAs), and 
converted keys. 

Output record length is the length of the output record. The length is 
computed from the input record length, the sort process, and the record 
reformatting requested. 

Sort tree size is the number of records that fit in sort's internal sort data 
structure. 

Number of initial runs is one indication of how well the data fits into 
memory. 

The maximum merge order is the maximum number of sorted strings that 
are merged at one time. 

The number of merge passes is the number of times SORT merges strings 
until one sorted output string is produced. The number of initial runs and 
the number of merge passes indicate how well the data fits in memory. The 
higher these numbers, the further the working set size is from containing the 
data, and the longer the sort takes. 

Work file allocation is the number of blocks used for the work files. When 
more than one merge pass is needed, this size is approximately twice the size 
of the input file allocation. 

Elapsed CPU is the CPU time used by the ordering operation; it does not 
include time spent waiting for I/O operations to complete or time spent 
waiting while another process executes. 


EXAMPLE 

$ SORT /STATISTICS PRICE1.DAT.PRICE2.DAT PRICE.LIS 


This SORT command results in the following statistical display: 
VMS Sort/Merge Statistics 


Records read: 

793 

Input record length: 

80 

Records sorted: 

793 

Internal length: 

80 

Records output: 

793 

Output record length: 

80 

Working set extent: 

100 

Sort tree size: 

412 

Virtual memory: 

433 

Number of initial runs: 

2 

Direct I/O: 

22 

Maximum merge order: 

2 

Buffered I/O: 

9 

Number of merge passes: 

1 

Page faults: 

3418 

Work file allocation: 

114 

Elapsed time: 00:00 

:05.98 

Elapsed CPU: 00:00: 

:03.63 


In the sample statistics display, the sort data structure size is limited by the 
small working set extent. By doubling the working set extent you can almost 
double the sort data structure size, enabling all the records to fit in memory 
without using work files. 
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/WORK. 

-FILES 


Used for optimization. 

FORMAT 

/WORK_FILES=n 

QUALIFIER 

VALUE 

n 

Specifies the number of work files requested; 0 to 10 files may be specified. 

DESCRIPTION SORT does not create work files until it needs them. If SORT needs work 

files, it creates two by default (SORTWORKO, SORTWORK1), which are 
placed in SYS$SCRATCH. Usually, there is no advantage to requesting more 
than one work file. However, if the available disks are too small or too 
full for SORT work files, you can increase the number of work files by any 
number from 1 through 10 to make each work file smaller. 

EXAMPLE 


$ ASSIGN DRA5: 

SORTWORKO 


$ ASSIGN DBO: S0RTW0RK1 
$ ASSIGN DB1: S0RTW0RK2 
$ S0RT/KEY=(POS:1,SI:80)/W0RK_FILES=3 - 
_$ STATS1,STATS2,STATS3,STATS4 SUMMARY.LIS 

Since the input files in this sort operation are large files, specifying three work 
files improves the efficiency of the sort operation. 
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EXAMPLE 

$ S0RT/KE=(POS:40,SIZ:2,DESC) - 

_$ CRAO:YRENDAVG.DAT/FORMAT=(RECORD_SIZE:41.FILE,SIZE:3) DESCYRAVG.LIS 

Because the input file, YRENDAVG.DAT, does not reside on a disk device or 
ANSI magnetic tape, file organization must be described by the /FORMAT 
qualifier. 
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OUTPUT FILE 
QUALIFIERS 


This section describes the qualifiers to the output file. These qualifiers should 
be specified immediately after the output file specification. 
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/CONTIGUOUS 



Output File Qualifier 

Used for optimization. 

FORMAT 

output filespec /CONTIGUOUS 

DESCRIPTION 

By default, SORT/MERGE does not allocate contiguous disk blocks for 
the output file. You can request, however, that the output file be stored in 
contiguous disk blocks by specifying the /CONTIGUOUS qualifier, thereby 
decreasing access time. If you use the /CONTIGUOUS qualifier, you must 
also specify the /ALLOCATION qualifier because, if the preallocated space is 
too small, RMS may be unable to extend the file contiguously. 


EXAMPLE 

$ SORT/KEY=(POS:1,SIZ:80) STATS.DAT - 
_$ SUMMARY. LIS/ALLOCATION 1000/CONTIGUOUS 

This SORT command allocates 1000 contiguous blocks for the output file, 
SUMMARY.LIS. 
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/FORMAT 

Output File Qualifier 

Specifies the output file record format if it differs from the input file format. 

FORMAT 

output filespec/ FORM AT =(type:n ...) 

QUALIFIER 

VALUES 

FIXEDin 

Specifies fixed-length records in the output file. 

VARlABLEin 

Specifies variable-length records in the output file. 

CONTROLLED:n 

Specifies variable with fixed-length control (VFC) records in the output file. 

n 

Optionally indicates the maximum record size (in bytes) of the output records. 
The maximum record size allowed depends on the file organization. 

Sequential files 32,767 

Relative files 16,383 

Indexed-sequential files 16,362 

These totals include control bytes. If you do not specify the maximum record 
size, the default is a length large enough to hold the longest output record. 

SIZE:n 

Specifies the size, in bytes, of the fixed portion of VFC (CONTROLLED) 
records, up to a maximum of 255 bytes. If you do not specify SIZE, the 
default is the size of the fixed portion of the first input file. If you specify this 
size as 0, RMS defaults the value to 2 bytes. 

BLOCK—SIZE:n 

Specifies the output file's block size, in bytes, if you have directed the file 
to magnetic tape. You can also accept the default. If the input file is a 
tape file, the block size of the output file defaults to that of the input file. 
Otherwise, the output file block size defaults to the size used when the tape 
was mounted. 

Acceptable values for block size (n) range from 20 to 65,532. To ensure 
correct data interchange with other DIGITAL systems, however, specify a 
block size of not more than 512 bytes. For compatibility with most non- 
DIGITAL systems, the block size should not exceed 2048 bytes. 
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/OVERLAY 

Output File Qualifier 

Specifies that the output file is to be overlaid on, or written to, an existing 
empty file. 

FORMAT 

output filespec /OVERLAY 

DESCRIPTION 

If you specify indexed-sequential organization, the output file must already 
exist and must be empty. You must specify that the empty file is to be 
overlaid with the sorted records by using the /OVERLAY qualifier. 

If the input file organization is sequential or relative and if you create an 
empty file for the sorted records using an RMS program, use the /OVERLAY 
qualifier to specify that the output file is to be overlaid. 

You can use the Create/FDL Utility to create an empty data file; use the 
/OVERLAY qualifier to specify that SORT is to write output to that file. 

Any attributes that you specify when creating the empty file then become 
attributes of the SORT output file. See the VMS Record Management Services 
Manual for more information. You can also refer to this manual if you want 
to use the Convert Utility to produce an indexed-sequential file on output. 


EXAMPLE 

$ CREATE/FDL=NEW.FDL AVERAGE.DAT 

$ S0RT/KEY=(P0S:1,SI:80) STATS.DAT AVERAGE.DAT/OVERLAY 

The FDL file, NEW.FDL, specifies special attributes for the file, 
AVERAGE.DAT. When SORT writes output to that file, the resulting SORT 
output file has the attributes specified by the FDL file. 
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/RELATIVE 

Output File Qualifier 

Defines output file organization as relative. 

FORMAT 

output file spec/ RELATIVE 

DESCRIPTION 

If the organization of the output file is to be different from that of the input 
files, then you must specify the new organization. If you do not specify file 
organization, the default for record and tag sorts is the organization of the 
first input file. You must use the /RELATIVE qualifier to specify relative 
output file organization. 

EXAMPLE 


$ S0RT/KEY=(P0S:1,SI:80) STATS.DAT SUMMARY.LIS/RELATIVE 

Because the input file, STATS.DAT, is not a relative file and the output file, 
SUMMARY.LIS, will be, /RELATIVE qualifies the output file specification. 
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/CDD_PATH_NAME 



Specification File Qualifier 

Allows use of the Common Data Dictionary record definitions. 

FORMAT 

/CDD_PATH_NAME="cdd-path-name" 

QUALIFIER 

VALUES 

"cdd-path- name " 

Specifies the CDD record definition. 

DESCRIPTION 

You can use the /CDD—PATH—NAME qualifier only if your system has 

VAX Common Data Dictionary (CDD) installed. The /CDD—PATH—NAME 
qualifier identifies CDD-defined fields and attributes for SORT. The cdd-path- 
name specifies a record definition within the CDD. Identifying these fields 
with this qualifier is the same as specifing them with the /FIELD qualifier. 
/CDD—PATH—NAME can be used in place of or in conjunction with /FIELD 
statements. Once the fields have been identified, they can then be used in 
later specification file clauses, such as /KEY, /CONDITION, /INCLUDE, or 
/OMIT. 


EXAMPLE 

/CDD_PATH_NAME="customer" 

This /CDD—PATH—NAME qualifier identifies the customer record, which 
was previously identified in the CDD. 
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/CHECK-SEQUENCE 



Specification File Qualifier 

Specifies whether or not the sequence of records is checked. 

FORMAT 

/CHECK-SEQUENCE 

/NOCHECK—SEQUENCE 

DESCRIPTION 

By default, MERGE checks the sequence of records in the input files. If you 
want to override that default, specify /NOCHECK_SEQUENCE in your 
specification file text. 

EXAMPLE 


/NOCHECK.SEQUENCE 

This /NOCHECK_SEQUENCE clause overrides MERGE's default behavior. 
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%■ 

• A single character can be equated to a double character sequence ("C" - 
"CH"). 

IGNORE 

Specifies that SORT/MERGE ignore a character or character range in the 
collating sequence when making an initial comparison. Note that, when 
tie-breaking takes place, SORT/MERGE considers the characters specified 
in the IGNORE clause. Tie-breaking takes place when two or more strings 
have compared as equal and the MULTINATIONAL sequence is being used 
or when two or more strings have compared as equal and the TIE—BREAK 
clause has been specified. 

FOLD 

Specifies that all lowercase letters be given the collating value of their 
uppercase equivalents. For ASCII, EBCDIC, and user-defined sequences, 
the lowercase letters are a through z. 

Since the lowercase letters in the MULTINATIONAL sequence already 
have the collating value of their uppercase equivalents, the use of FOLD is 
unnecessary. 

TIE-BREAK 

NOTIE-BREAK 

Specifies whether or not SORT/MERGE should use numeric values to break 
any ties between characters that have equivalent values. By default, tie¬ 
breaking occurs with the MULTINATIONAL sequence. Specifying NOTIE- 
BREAK overrides this default and ensures that no further comparisons are 
made after the initial comparison. 

A TIE—BREAK option must be specified for the ASCII, EBCDIC, and user- 
defined sequences in order for tie-breaking to occur. TIE—BREAK should be 
used when specifying FOLD or MODIFICATION for the these sequences. 

DESCRIPTION 

The /COLLATING-SEQUENCE clause specifies the collating instructions for 
a sort or merge operation. In a /COLLATING-SEQUENCE clause, you can 
specify ASCII (the default), EBCDIC, or MULTINATIONAL sequence; you 
can also define your own sequence. 

In addition, the MODIFICATION, IGNORE, FOLD, and [NO]TIE —BREAK 
options of the /COLLATING-SEQUENCE clause can be used to modify any 
of these sequences. You can make more than one modification to the collating 
sequence. If you intend to modify any collating sequence, you must specify 
the sequence in the SEQUENCE option, even if it is the default sequence 
(ASCII). 

Because the FOLD, MODIFICATION, and IGNORE clauses are processed in 
the order in which they are specified, care should be taken when specifying 
the order of those clauses. Normally, FOLD should be specified after all 
MODIFICATION and IGNORE clauses to ensure that the effects of the 
MODIFICATION and IGNORE clauses apply to uppercase and lowercase 
characters. 

You can request that SORT/MERGE ignore a character or character range 
within the given collating sequence by using an IGNORE clause. 
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By default in the MULTINATIONAL collating sequence, SORT/MERGE folds 
lowercase letters onto their uppercase equivalents. If you want this folding to 
occur in the other collating sequences, you must specify a FOLD clause with 
the instructions for the collating sequence. 

Also by default in the MULTINATIONAL collating sequence, SORT/MERGE 
uses numeric comparisons to break any ties in the collating values. Ties 
occur when two equal keys collate the same. If you do not want the default 
when using the MULTINATIONAL collating sequence, specify the keyword 
NOTIE —BREAK. For tie breaking in the other collating sequences, specify a 
TIE_BREAK clause. 


EXAMPLES 

Q /COLLATING_SEQUENCE=(SEQUENCE=ASCII,IGN0RE=") 

This /COLLATING-SEQUENCE clause with an IGNORE option specified 
results in the following fields being compared as equal before tie breaking: 

252-3412 
252 3412 
2523412 


E 


E 


/COLLATING_SEQUENCE= (SEQUENCE= ("A"-"L" , "LL" , "M"-"R" , "RR" , "S"-"Z")) 


This /COLLATING—SEQUENCE clause defines a sequence in which the 
double character LL collates as a single character between L and M, and the 
double character RR collates as a single character between R and S. These 
double characters would otherwise appear in their normal alphabetical order. 
By default, this user-defined sequence does not define any other characters, 
such as lowercase a through z. 


/COLLATING_SEQUENCE=(SEQUENCE= 

("AN","EB","AR","PR","AY","UN","UL", 
"UG","EP","CT","OV","EC","0"-"9"), 

M0DIFICATI0N=(">"="19"), 


! User-defined sequence 
! that gives each month 
! a unique value in its 
! chronological order 


FOLD) 


This /COLLATING—SEQUENCE clause defines a collating sequence that 
allows you to order a file SEMINAR.DAT according to the seminar date. The 


16 

NOV 

1983 

05 

APR 

1984 

11 

Jan 

’84 

12 

OCT 

1983 

15 

MAR 

1984 

08 

FEB 

1984 

07 

Dec 

’83 

14 

SEP 

1983 


Communication Skills 
Coping with Alcoholism 
How to Be Assertive 
Improving Productivity 
Living with Your Teenager 
Single Parenting 
Stress — Causes and Cures 
Time Management 


The primary key is the year field; the secondary key is the month field. 
Because the month field is not numeric and you want the months ordered 
chronologically, you must define your own collating sequence. You can 
do this by sorting on the second two letters of each month — in their 
chronological sequence — giving each month a unique key value. 
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Note: Normally, you don't need to specify the radix operator (%D); however, 
test-condition will assume the same data type as the field-name. 

The field-name must be defined in a /FIELD clause. 


DESCRIPTION A specification file can be used to change the relative order of a record 

or to alter the contents of certain fields of a record. You must first use a 
/CONDITION clause to define a conditional test. Once you define a test in 
a /CONDITIONAL clause, you can use that same test in a /KEY or /DATA 
clause to change the order of record or in a /OMIT or /INCLUDE clause to 
change the contents of a record. 

If you want to change the order of records in the output file, you first specify 
a condition name in a /CONDITION clause and set up a test for what meets 
that condition. Then, you would specify the relative order in a /KEY clause 
of the form: 

/KEY=(IF condition-name THEN value ELSE value) 

You can use any values to specify the relative order of the records. 

The /CONDITION clause also permits you to change the contents of a field 
in the output records. First specify a condition name, and then set up a test 
for what meets the condition. Specify the contents you want in the field in a 
/DATA clause of the form: 

/DATA=(IF condition-name THEN "new-contents" ELSE M new-contents") 


EXAMPLES 

Q /FIELD=(NAME=AGENT,POSITION:20,SIZE:15) 

/CONDITION (NAME=AGENCY. 

TEST=(AGENT EQ "Real-T Trust" 

OR 

AGENT EQ "Realty Trust")) 

/DATA=(IF AGENCY THEN "Realty Trust" ELSE AGENT) 

In this example, two real estate files are being sorted. One file refers to an 
agency as Real-T Trust; the other refers to the same agency as Realty Trust. 
The /CONDITION and /DATA clauses instruct SORT to list the AGENT field 
in the sorted output file as Realty Trust. 

2 /FIELD=(NAME=ZIP.POSITION:60.SIZE:6) 

/C0NDITI0N=(NAME=L0CATI0N. 

TEST=(ZIP EQ "01863")) 

/KEY=(IF LOCATION THEN 1 
ELSE 2) 

In this example, all the records with a zip code of 01863 will appear at the 
beginning of the sorted output file. The conditional test is on the ZIP field, 
defined in the /FIELD clause; the condition is named LOCATION. The values 
of 1 and 2 in this /KEY clause signify a relative order for those records that 
satisfy the condition and those that do not. 
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SORT/MERGE 

/CONDITION 


0 /FIELD=(NAME=ZIP,POSITION:60.SIZE:6) 

/C0NDITI0N=(NAME=L0CATI0N, 

TEST=(ZIP EQ "01863")) 
/DATA=(IF LOCATION THEN "NORTH CHELMSFORD" 
ELSE "Outside district") 


In this example, the /CONDITION clause tests for the 01863 zip code. The 
/DATA clause specifies that the name of town field will be added to the 
output record, depending on the test results. 

Q /FIELD=(NAME=FFLOAT,POS:1,SIZ:0,F.FLOATING) 

/C0NDITI0N=(NAME=CFFLOAT,TEST=(FFLOAT GE 100)) 

/0MIT=(C0NDITI0N=CFFL0AT) 

In this example, the number 100 is considered to be a F_floating data type 
because field FFLOAT is defined as F—FLOATING in the /FIELD clause. 
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/FIELD 

Specification File Qualifier 

Defines the fields in the input files. 

FORMAT 

/FIELD=(NAME=field-name,POSITION:n,) 

SIZE:n,[DIGITS:n,]data-type 

QUALIFIER 

VALUES 

NAME=field-name 

Specifies the name of the field. The field-name cannot have any embedded 
blanks, must begin with an alphabetic character, and can be no longer than 

31 characters. 

position™ 

Specifies the position of the field in the record. 

size™ 

Specifies the size of a field containing character or binary data. In the 
specification file, SIZE implies byte lengths. The data type determines what 
values are acceptable, as follows: 

• For character data, the size must not exceed 32,767 characters. 

• For binary data, the size specified must be 1, 2, 4, 8, or 16 bytes. 

• For floating-point data, no size is specified. 

DIGITS:n 

Specifies the size of a field containing decimal data. The size of a field 
containing decimal data must not exceed 31 digits. Note that DIGITS:n is 
used only when describing a field containing decimal data. 

data-type 

Specifies the data type of the field. You are not required to specify the data¬ 
type if it is character; SORT assumes character data type by default. The 
following data types are recognized by VMS SORT/MERGE: 

CHARACTER 

BINARY[,SIGNED] 

BIN ARY,UNSIGNED 

D-FLOATING 

F_FLOATING 

G-FLOATING 

H—FLOATING 

ZONED 

DECIMAL[,SIGNED,TRAILING_SIGN,OVERPUNCHED_SIGN] 
DECIMAL,LEADING_SIGN,SEPARATE_SIGN[,SIGNED] 
DECIMAL,LEADING_SIGN,[OVERPUNCHED_SIGN,SIGNED] 

DECIM AL,[TRAILING -SIGN], SEPARATE _SIGN[,SIGNED] 

DECIMAL,UNSIGNED 

PACKED-DECIMAL 
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SORT/MERGE 

/FIELD 


DESCRIPTION If you are altering the order or format of output records, you must identify 

each field of the records. These fields include key fields, fields to be 
compared, and fields to be directed to the output file. You identify each 
field by specifying a name, its position and size in the record, and its data 
type in the /FIELD clause. 

Once the field-name has been specified in the /FIELD clause, it can be used 
in the /CONDITION, /KEY, and /DATA clauses. 


EXAMPLE 

/FIELD=(NAME=SALARY,POSITION:10,DIGITS:8,DECIMAL) 

This /FIELD clause identifies a field in a record by the name SALARY, 
specifies that it starts in position 10 of the record, is 8 digits long, and consists 
of decimal data. 
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/KEY 

Specification File Qualifier 

Specifies the key fields. 

FORMAT 

/KEY=field-name 

/KEY=(field-name,order) 

/KEY=([IF condition-name THEN value ELSE]...) 
value [,order] 

QUALIFIER 

VALUES 

field-name 

Specifies the name of the key field. The field-name has been previously 
specified in a /FIELD clause. 

order 

Specifies the order of the sort. The ASCENDING option specifies ascending 
order for a sort or merge operation. This option is the default. The 
DESCENDING option specifies descending order for a sort or merge 
operation. 

value 

Specifies the key. The value can be a constant or a field-name that has been 
defined in a /FIELD clause. 

DESCRIPTION 

If you are sorting on the entire record using character data, there is no need 
to specify your key field. Otherwise, you must specify a /KEY clause for each 
of the keys, in the order of their priority. You can sort on as many as 255 key 
fields. 

There are three ways to use the /KEY clause. First, you can use the /KEY 
clause to identify the key field name. Second, you can use the /KEY clause 
to identify the key field name and to specify sorting order. In this case, you 
must enclose the field name and the order option in parenthesis. Finally, 
you can use a conditional /KEY clause to change the order of records in the 
output file. You first specify a condition name in a /CONDITION clause 
and then set up a test for what meets that condition. Then, you specify the 
relative order in a /KEY clause of the form: 

/KEY=(IF condition-name THEN value ELSE value) 

You can use any values to specify the relative order of the records. 
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SORT/MERGE 

/KEY 


EXAMPLES 

Q /FIELD=(NAME=SALARY.POSITION:10,DIGITS:8.DECIMAL) 

/KEY=(SALARY,DESCENDING) 

This /KEY clause specifies that the key field is SALARY and that the sorting 
order is descending. 

0 /FIELD=(NAME=ZIP,POSITION:20,SIZE:6) 

/C0NDITI0N=(NAME=L0CATI0N. 

TEST=(ZIP EQ "01863")) 

/KEY=(IF LOCATION THEN 1 
ELSE 2) 

In this example, all the records with a zip code of 01863 are to appear at the 
beginning of the sorted output file. The conditional test LOCATION (defined 
in a /CONDITION clause) is on the ZIP field (named in a /FIELD clause). 
The values of 1 and 2 in this /KEY clause signify a relative order for those 
records that satisfy the condition and those that do not. 
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/PROCESS 

Specification File Qualifier 

Defines the processing method for the sorting operation (SORT only). 

FORMAT 

/PROCESS=type 

QUALIFIER 

VALUES 

RECORD 

Specifies the record sort. This SORT process is the default. 

TAG 

Specifies the tag sort. 

ADDRESS 

Specifies the address sort. 

INDEX 

Specifies the index sort. 

DESCRIPTION 

By default, SORT uses a record sorting process. You can also specify a 
tag, address, or index sorting process. If you intend to reformat the output 
records, you cannot use address or index sort. For a comparison of the four 
processes, see the description of /PROCESS in the Command Qualifiers 
Section. Use the /PROCESS clause with SORT only. 


EXAMPLE 


/PROCESS=tag 

This /PROCESS clause specifies that SORT use a tag sorting process. 
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/STABLE 

Specification File Qualifier 

Specifies that records with equal keys are directed to the output file in 
their input file order. The default condition is /NOSTABLE. 

FORMAT 

/STABLE 

/NOSTABLE 

DESCRIPTION 

By default, the order of output records with equal keys is unpredictable. 
Specifying the /STABLE clause in a specification file arranges records with 
equal keys in the output file in the order of the input files as specified in the 
command line. If you use this qualifier when sorting multiple input files, on 
output, records with equal keys in the first file will precede those from the 
second file and so on. 


EXAMPLE 


/STABLE 

This /STABLE clause ensures that records with equal keys will have the same 
order in the input and output files. 
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